home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 71.zip / BS1 part 71 / X-Cad3000_d5.adf / XCdoc / listnet < prev    next >
Text File  |  1991-11-22  |  6KB  |  131 lines
  1.  
  2.    ? LIST NETWORK
  3.  
  4.  
  5. LIST NETWORK is used to obtain a routing list of any Netline networks  in  a
  6. drawing, plus an optional list of components associated to the network.  
  7.  
  8. The  network  route  or  from-to  list  is  made up of 3 components; source,
  9. network label, and destination. The source and destination are obtained from
  10. the terminating ends of each network. This can be the name on a Symbol, text
  11. obtained from a Tnode or the Terminal at the network end, or the name of  an
  12. associated  network  if  the  reported network starts or ends on a different
  13. network.  
  14.  
  15. If a network starts or terminates at a non-juntion Terminal, then the source
  16. or destination description is formatted
  17.  
  18.    Item_name-Terminal_name
  19.  
  20. where  Item_name  is  taken  from  the  Text related to a Tnode related to a
  21. Symbol related to the terminating Terminal. If the  Symbol  related  to  the
  22. Terminal  has  more  than  1 associated Tnode, then the Tnode containing the
  23. attribute ITEMNAME is used to obtain the network end description.  
  24.  
  25. Terminal_name is taken from any Text  entity  related  to  the  network  end
  26. Terminal.  
  27.  
  28.    NETWORK TRACING
  29.  
  30. The  limits  of each indivdual network can be defined in 3 different ways: A
  31. single terminal to which only a single Netline is attached; a Terminal  with
  32. the attribute NETBREAK; or a junction at which the network flow is halted.  
  33.  
  34. Network  flow across junctions can be defined explicitly, or can be left for
  35. the command  to  decide.  When  a  junction  of  more  than  2  Netlines  is
  36. encountered,  the  Netline  that  starts or ends at the junction Terminal is
  37. examined for the BRANCH attribute.  If  this  attribute  exists,  then  this
  38. network is assumed to start or end at this junction. If the BRANCH attribute
  39. does not exist, the network  flow  is  routed  along  any  other  non-BRANCH
  40. Netline  associated  to  the  junction  whose flow direction matches that of
  41. current Netline. If there is more than one valid Netline to choose  from  in
  42. this  case,  then  the  in-coming and out-going Netlines across the junction
  43. Terminal must be colinear.  
  44.  
  45. Thus to avoid ambiguity, the BRANCH  attribute  should  be  used  to  decide
  46. network  flow  across  junctions.  In  the  simple  case  of  a "T" junction
  47. containing no Netlines with the BRANCH attribute, the network flow is always
  48. across the bar of the "T" if the flow direction match.  
  49.  
  50. The default description of a network route is in the format
  51.  
  52.    SOURCE      LINE-LABEL     DESTINATION
  53.  
  54. If the network contains more than one label, then the output format changes
  55. to
  56.  
  57.    SOURCE      LINE-LABEL-1
  58.                LINE-LABEL-2
  59.                     :
  60.                LINE-LABEL-n   DESTINATION
  61.  
  62. Each  section  of the network using a different line label must be delimited
  63. by a Terminal containg the attribute NETCHANGE.  If  this  Terminal  is  not
  64. found, then any one of the multiple labels will be used to tag the network.  
  65.  
  66.    COMPONENT SCHEDULE
  67.  
  68. The  component list option will generate for each network, a schedule of all
  69. components that belong to the network. A component is  a  Symbol  containing
  70. one  or  more  Terminals  linked into the network. Components that should be
  71. excluded from the schedule - such as TEEs etc - should  have  the  attribute
  72. NOREPORT.  
  73.  
  74. The  component  schedule  is  made  up  of 4 optional parts: Component type,
  75. component description; component name; and the label of the section  of  the
  76. network in which the component is situated.  
  77.  
  78. The  component  type  is  extracted  as  the value of the COMPTYPE attribute
  79. associated with the component Symbol. The component description is extracted
  80. from  the  COMPDESC  attribute  associated  with  the  component Symbol. The
  81. component name is taken from the text related to a Tnode having the COMPNAME
  82. attribute.  This  Tnode must be related to the component Symbol. The network
  83. label is the first label encountered downstream from the component.  
  84.  
  85.  
  86.    COMMAND FORMAT
  87.  
  88.       #LIST NETWORK [modifiers] :Netline d1 ... dn
  89.  
  90. One or more Netline entities are identified via IDENTS.
  91.  
  92.  
  93.    MODIFIERS
  94.  
  95. TO             Specifies the name of the output file to which the network
  96.                and component schedule is written. If this modifier is
  97.                not used, the schedule is printed to the text window.
  98.  
  99. SOURCE         Specifies the column position in the report to place the
  100.                source description.
  101.  
  102. LABEL          Specifies the column position in the report to place the
  103.                network label name.
  104.  
  105. DESTINATION    Specifies the column position in the report to place the
  106.                destination description.
  107.  
  108. COMPONENT      This modifier is used as a flag to indicate that a
  109.                component schedule is required. If non of the lower level
  110.                modifiers are used, all 4 fields of the component schedule
  111.                are listed at their default column positions.
  112.  
  113. .TYPE          Specifies the column position in the report to place the
  114.                component type text. If a value of zero is entered, this
  115.                field is excluded from the component schedule.
  116.  
  117. .DESC          Specifies the column position in the report to place the
  118.                component description text. If a value of zero is entered,
  119.                this field is excluded from the component schedule.
  120.  
  121. .NAME          Specifies the column position in the report to place the
  122.                component name text. If a value of zero is entered, this
  123.                field is excluded from the component schedule.
  124.  
  125. .LINE          Specifies the column position in the report to place the
  126.                component line label text. If a value of zero is entered,
  127.                this field is excluded from the component schedule.
  128.  
  129. HEADER         A toggle used to specify if a header is required for the
  130.                report.
  131.